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CONGRATULATIONS! 



You now own APPLIED ENGINEERING'S Z-80 catd. Applied Engineering 
is a leading manufacturer of Apple peripherals. Because of the 
time and care taken in the design and manufacture of your Z-80 
card, we are sure that you will enjoy the use of it for many 
years to come. 

This manual was written with a Z-80 Plus card and Wordstar using 
an Apple lie. 
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fiPPLE PERIPHERAL CARDS: WHAT GOES WHERE 

tJnlike Applesoft and Integer BASIC {but similar to Apple Pascal) 
many programs that use the Z-80 card require that peripheral I/O 
cards be plugged into specific slots depending on their use. The 
peripheral card assignments for the Z-80 Gatd are the same as for 
Apple Pascal so if your System is set up for Apple Pascal, no 
rearrangement is necessary- Please refer below for the correct 
assignment of peripheral cards for the various Apple slots. 



SLOT 

17AM Card or Basic ROM (Apple lie has no slot 0,) 

1 Printer Interface 

2 General Purpose I/O tJ^usic Synthesizer, Modem, A/D, etc) 

3 Q& Column Card or G,P. I/O 

4 Timemaster clock, z-80 Plus Card or G.P, I/O 

5 Disks 3 and 4, Z-Q0 Plus or G,P, l/O 

6 Disk Drive 1 and 2 

(Must have at least one drive in Slot 6) 

7 Z-'80 Plus Card, or G.P. I/O 
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INSTALLING THE Z-^80 PLUS CARD IN YOUR APPLE 

The Z-80 PIqs card simply plugs into a connector inside the Apple 
computer- Care must be exercised however, so follow these 
instructions exactly. 



1) TURN OFIT THE APPLE'S POWER SWTT.CHi This is very important to 
prevent damaging the computer as well as your Z-B0 Plus card, 

2) Remove the cover from the Apple. This is done by pulling up 
on the covec at the rear edge (the edge farthest from the 
keyboard) unti 1 the two corner fasteners pop apart. Than 
slide the cover up and backwards until it comes f ree- 

3) Inside the Apple, across the rear of the main circuit board, 
there is a row of eight long narrow sockets called "slots" i 
Vou can plug your Z-St[ plus into any sl-o.t except 0. (The 
Apple lie has no slot 0.) slot 7 is the recommended slot to 
install the card with slot 5 being next. Insert the fingers 
of the circuit board into the slot you want. The fingers 
will enter the slot with some friction and then seat firmly. 



■• 
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4) Carefully recheck your work and replace the Apple's cover by 
sliding the front edge into place. Then press down on the 
rear corners until they pop into place. 



The Applied Engineering Z-80 Plus card has all the necessary 
hardware to interface a Z-80 microprocessor (contained on the 
card) to the Apple computer. The Applied Engineering Z-Bfl card 
fiermits the direct execution of B08Gf, 8085 and 2-S0 programs, 
including Digital Research's Cp/M operating system as well as all 
of the programs that execute in the CP/M software environment. 
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GETTING STARTED 

Once the Z-QCT card is installed in the computer, you're ready to 
start Ljsiag CP/M software. The CP/AM 4,0B system master diskette 
that came with your Z-80 card should be copied using the 
following procedure, 

1) Insert CP/AM master diskette in drive I and turn on computer. 

I 2) The copyright notice will appear in the upper left hand 

-J co-rner of the screen. Just below the copyright notice will 

be the CP/AM prompt 'A>', At this point, type the 
ioliowings 

COPX B:=A: 

If your system has only one disk drive, then type; 
copy A:^A: 

Following the directions on the screen, place a blank diskette in 
drive B (slot 6, drive 2) £oz a two drive system, whereas single 
drive users wiii have to swap disks at the designated time, 

3} Press return key to begin copying, 

4) Then make a second backup copy_ 

5) Label the two backup diskettes and store the original iti a 
safe place. 

As a general rule, original diskettes should never actually be 
used, but rather only be used to make copies from and then use 
the copies. 

Larger Memory Capacity 

If the system being used is an Apple He, Apple //c, or an Apple 
II or 11+ with a 16K language the CP/AM operating system can be 
upgraded to a 60K system from the standard 44K system that is 
already on the dislt. This can be done by executing the CPAM60 
program on each of the backup diskette as shown below: 

A>CPAH60 



and following the instructions. Additional information about 
this program can be found in the transient program section. 
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Pressing RESET 



DON'T PRESS RESET - When programming in Apple BASIC, some people 
have gotten used to pressing Reset to break out of a program. 
This habit must be broken when using CPM software- Remember, 
official Apple doctrine states that when Reset is pushed "all 
bets are off". 



SOFTWARE COMPATIBILITY 



CP/AK 4\0a is compatible with virtually all older CPM systems- 
When purchasing software, you need not look for any mention of 
CP/AK 4-0B specifically as this operating system is compatible 
down to CPK 1*6* 99.9% of all the programs that you will buy 
will require CPM 2,2 for which CP/AM 4.0B is compatible. 



Creating a system diskette 



A system diskette is one that will load and initialize CP/AK wheh 
booted. To create a sy tern diskette on a two drive system, type: 

COPY B:=A:/S 



On a one drive system type: 

COPY A:=A:/S 

The /S means copy only the system and do not copy the other files 
on the disk. The new CP/AM system disk will now boot and can be 
used to store programs and data * The /S command is somewhat 
similar to the DOS 3.3 INITialize except that /S will not erase 
programs on the diskette. This command is also used to put the 
operating system on commercially prepared programs so that they 
will cold boot with no preboot. Many commercially prepared 
programs will refer to a SYSGEN command. The /S is the SYSGEN 
under CP/AM 4,0B- Only use the /S command on BACKUP copies of 
programs because if you should make an error , the original disk 
could be damaged. 




INTRODUCTION TO CP/AM 

PILE NAMES 

File names in the CP/AM system follow the following focmati 

d:f ilename- typ 

The drive specification, which is optional, identifies which 
drive the file is located on is given by 'd;', where the lower 
case 'd' can be any drive name. The 'filename^ can be from 1 to 8 
characters, this can be followed by an optional file type 
specifier- The type specifier of the filename must be preceded 
by a period followed by a maximum of three characters. The 
period is not part of the file name, but only a separator . There 
are a few characters that are not allowed in a file name and are 
listed below: 

There is a general convention that Is followed by the CP/M world 
on what special file type names mean , These file type names 
identify the format of a file, which is used by many programs. 
To avoid problems, it is recommended that the following type 
names be used only for their intended purpose; 

.ASM Assembly language source cade for the ASM program* 

.MAC Macro assembly language 

-HEX Hexadecimal file output by assemblers 

,REL Relocatable file output by assemblers 

.COM Command file that can be executed by entering its 

file name alone 

.PRK print file 

-LIB Library file of programs 

pSUB Input for CP/M type batch facilities 

•C G language source code 

.PAS Pascal source code 

• COB^ COBOL source code 

.FTN FORTRAN source code 

-TXT Text files 

. DOC Documentation files 

.555 Temporary files 

Through the use of special "wild card' characters CP/AM has the 
capability to refer to one or more files at the same time. 
There are two special characters that can be used, the '?' and 
**', of these the '?' is the main wild card character. Where 
ever the '?' character appears in a file name that position will 
be matched with any character. Using the ^3' character all of 
the iiles on a disk can be matched by typing '????????.???', As 
an example, the files 'TEMPI. DOC' and 'temp2,D0C' e^ti be matched 
at the same time with 'TEMP7.DOC' - Although the file name 
■TEMP10.DOC' would not match because it has another character 




after the position that the '?' matches. The file 
^TEMP??.DOC' would however match all three file names. 



name 



To keep from having to type in many '?' characters another wild 
card character is provided, the '*'. This means to use as many 
'?■ as needed to fill out the rest of the name or type field- 
Thus, '????????.???' can be written as 
be matched with 'TEMP*,DOC'. 



I * * » 



and 'TEMP10.OOC' can 
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Default Disk Drive 



When a f i lename is used without a drive specifier , the default 
drive will be assumed for the operation- The default drive is 
indicated at the CP/AM prompt by the letter just to the left of 
the greater than sign. When the CP/AM system is first booted 
up the prompt 'A>' will be displayed. This shows that the 
default drive is 'A' and that the system is ready for a command. 
In the following command, lioe example: 



r 
'I 

■ iJ 



< i1 



B>A:STAT TEMP-TXT 

the default drive is 'B'. The transient program STAT has a 
drive specifier of 'A:' so the system will look on the disk that 
is in drive 'A' for the STAT program and if found, will execute 
it- The filename parameter of STAT is 'TEMP-TXT' which has no. 
drive specifier. When the STAT program begins to run it will 
look for the file "TEMP. TXT' on the default dcive 'B' 
found, will display the file size- 



md if 



TO. change the default disk drive, simply type the drive letter 
followed by a colon, then return. For example, to go to drive B 
just type 'B:', If the disk drive is not currently logged in, 
the CP/AM system will read the directory information from the 
disk and log it in. After this, the CP/AM prompt ■b>' will 
appear. If the disk is already logged In, the system will not 
have to read the directory and the prompt will appear 
immediately. From this point on, all further disk commands will 
use drive B as the default. 



Each disk drive is assigned a 
shown below: 



letter name followed by a colon as 



CP/AM name 


1st Drive 


A 


2nd Drive 


B 


3rd Drive 


C 


4th Drive 


D 



Slot Number 

6 
6 
5 
5 



Drive Number 

1 
2 
1 
2 



Changing CP/AM Disks 

Unlike Apple DOS, you cannot indiscriminately change disks in the 
drives with CP/AM- When you change disks, you must let CP/AM 
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know that you have done so. This is because there is certain 
information stored in memory about the disk in use- When you 
change disks, this information should be replaced with the 
information of the newly inserted disk- To let CP/AM know that 
you've changed disks, type control C after you've changed disks- 
If you do not type control C after changing disks and attempt to 
write to the changed disks, the computet will display: 

BDOS ERR ON d: 

If this message is displayed, press control C to return to CP/AM- 
Control C may be typed anytime you think it may be needed for it 
will not hurt anything. 

There are several ways to get the CP/AM operating system started 
iB the Apple, The easiest way is to simply turn on the computer 
with the CP/AH disk in drive A- Another method is to type 
CONTROL, OPEN APPLE, RESET (Apple lie onlyj • This is done by 
pressing the Control key and Open Apple key down simultaneously 
with the left hand, then pressing Reset with the right hand* If 
Apple DOS (3.3 or Pro-DOS) is currently running type PR#6 and 
press return - 

Once CP/AM has been booted, you are ready to begin experimenting 
with its various coinmands- If the disk will not boot, please see 
the section on page 30 called 'IN CASE OF DIFPICDLTY'* 



CP/AM Commands 

CPM commands fall into two categories, system commands and 
transient commands. System commands are built into the CP/AM 
system and always available whereas transient commands are 
programs that axe called up from the disk drives- If you ever 
try to execute a transient command and the computer responds with 
a question mark, this is because that particular command is not 
on the disk that you're using. It is a simple matter to copy 
these transient commands to other disks and this procedure will 
bfe outlined later. 



CP/AM System Commands 
DIR 

DIR stands foe Directory and is similar to typing Catalog under 
Apple DOS.. TO use this command, simply type DIR at the CP/AM 
prompt 'A>' followed by pressing the return key and it will give 
a Listing of all the files on the currently logged on disk. 

A>DIR 

A: PIP COM 28 : CPAM60 COM 42 : RESTOR DOC 5 

In the sample Directory above, three files are shown- They are 



PIP.COM, CPAM60-COM and BEST0R.DOC. One of the unique features of 
CP/AM 4.0B are the numbers following each file name. These 
numbers indicate the disk space that each file uses in pages. 
One IK U024 bytes) of memory equals faux pages,, so the PIP file 
is 28/4 oi 7K bytes long- 
By typing DIR and getting a successful directory, the z-80 card 
and the computer have been given a thorough hardware test- 
Should you ever encounter difficulties in the future, the system 
operation can be tested by cold booting on a master diskette and 
typing DIR. If this doesn't give successful directory, then the 
problem could be hardware related. If a proper directory is 
displayed, then contact the software publisher for help, 

TO get a directory of a different drive, just type 'DIR B:' for 
the directory on drive B. After displaying this directory, the 
system will be return to drive &, However, don't try to get a 
directory on drive B unless there is a CP/AH disk in that drive. 



Another way of displaying the directory is to ttse the transiant 
command SDIP, SDIB will sort the directory into alphabetical 
order and display some additional information about the disk. 
For more information refer to the transiant command section to 
the manual . 



ERA 

ERA is the erase command. Like DIR, it is a system command that 
can be used on any disk because it is built into the CP/AM 
operating system. Its format is very simple: 

A>EEA BiTEMP.BAK 

The above command will erase a temporary file on drive B:. The 
Bra command is somewhat unique because the drive letter must be 
specified and is not optional as in other CPM commands. To erase 
all the files on a disk {drive A: in this example) type : 



.'*• 



A>ERA A; 



* * 



A: 



* * 



When the return key is pressed all of the files on the disk will 
be removed. Be sure that this is really what you want to do for 
there will be no question asked tjefore the ERA command starts. 



KEN 

This command allows you to change the name of a file- The format 
is: 

REN new. typhoid, typ 

For example, assume the FILE21.TXT is on the diskette in drive A. 
After typing; 



lis 



1 



J 
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A>REN ftt:.e33,tkt=^file2i.txt 

FILE21 will be renaraed to PILE33, and only FILE33 will be on the 
diskette in drive A. The name FILE21 will have been discarded . 
The file itself, however , will remain intact. 



TYPE 

The TYPE command can be used to display any ASCII file on the 
screen. This is a quick and convenient way tQ examine any 
Cextfile- The format is; 

A>TYPE d: filename. typ 

The TYPE command can be used to view any text files on a disk- 
While it will not provide the convenient format of a word 
processor, TYPE does print the file as it is actually stored on 
the disk- Tt isa common practice to store documentation for 
many programs orj a CPM disk as a filename.DOC or f ilenaine.TXT- 
For example, on the CP/AM master diskette will be found a program 
called 'NSWEEP.DOC . After typing the following; 

TYPE A;NSWEEP.DOC 

the latest documentation on the program 'WSWEEP.COM' will be 
displayed . The TYPE command wi 11 display a page of information 
at a time- To view the next page, simply press return or for 
finer control, use control S- The listing can be stopped by 
typing control C, 



USER 

If several people or application programs share a single disk, 
the user command can be used to separate them onto different 
parts of the disk directory called USER AREAS- These user areas 
are normaly not used , however it can be very useful on syst^iis 
that have hard disk drives. 

The disk directory for each disk drive is be divided into sixteen 
different u@er areas- Kcich user area is logically separate from 
all other user areas except for user area zero, which is global 
to all user areas in the CP/AH system. When in user area zero , 
only the files contained in user zero will be displayed by the 
DIR command- All files that may be in the other user areas are 
not directly accessible from user zero- When in any of the other 
nonzero user areas the files contained in both user zero and 
those in the current nonzero user area are accessible and will be 
displayed by the DIB command . This allows different sets of 
related files to be isolated in thier own user areas with the 
common system programs that may be used by several users areas, 
such as text editors and compilers, to be placed in user area 
zero and shared between all user areas. In most circumstances. 
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as mentioned above, the usee acea facility can be ignored and all 
work done in user zero. 1^ user areas are going to be used, care 
must be taken so that no £^ilename is created, in a noazero user 
aj:ea that is also used in user area zero. 



T.Q mo V e to a d i f f eiren t 
fconi aero to fifteen, 
one; 



user area type 'USER' followed by a number 
The example below will move to user area 



A>USER 1 



The CP/AM prompt will change to 



aA> 



this indicates that user ^zea one is now active. The lower case 
letter to the left of the default drive letter will be 'a' for 
user 1, 'b' for user 2,,-. etc. through user fifteen. The DTR 
command will indicate which files belong to user zero and which 
belong to the current user area by prefixing the files contained 
in the nonzero user area with a lower case let tec of that user 
area - This is shown in the example below: 



A>USER 1 
aA>DIR 
S; PIP 



COM 26: STAT 



COM 13;aLETTER 



TXT 



3 



Both of the files PIP and STAT 
LETTER, TXT belongs to user one. 



belong to user zero and the file 



SAVE 

The save command allows a copy of the system memory to be saved 
to a file on disk- The format for the SAVE command is as follows 

SAVE n filename. typ 

where n is the number of 256 byte pages to be saved starting at 
hex address 100H- The following example will save 2048 bytes of 
the system memory starting at 100H to the file *MEMEAVE,XXX ' : 

A>SAVE 8 MEMSAVE>XXX 



1 
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Transient Commands 



PIP 



It is often desirable to move some of the utility programs from 
tliS system master diskette to a program diskette. To do this, a 
method of transferring files from one diskette to another is 
needed. 

The PIP program is used to perform copy operations- It is a 
program that you execute by typing 'PIP'. With the system master 
diskette in drive A and one of the diskettes that you recently 
formatted in drive B, type 'PIP', 

R>PIP 
iir 

The asterick prompt is the PIP program prompt and indicates that 

PIP is up and tunning, h PIP expression that will copy a filefs) 
from one disk to anotlier can now be typed- simple PIP 
expressions take this form: 

d:copyname -typ=d : original name, typ 

The 'copyname' and ' or iginalname' arguments are actual filenames, 
and the 'd' stands for the letter of the drive. The '.typ' means 
the file type that has been designated for that file. The 
extension '-typ' for PIP is '.COM'. PIP always copies from an 
original file to a copy file. Thus, the original fil-e must 
alceady exist; PIP creates the copy file with the name you supply 
(normally the same) . For example: 

*B : copy .C0M=A: COPY. COM 

This expression tells PIP to make a copy of C0PY.COM which is on 
drive A and to name it COPY, COM and put it oh drive B- More 
files can be copied from this point or, by pressing the return 
key, return ito the CP/AM 'A>' prompt. 

The new file cah be given a different name during the transfer as 
follows: 

*B:0tDCOPY,C0M=A; COPY -COM 

rf only one PIP operation is desired, then a shorter commmand can 
be used by typing the PIP expresssion on the PIP comraaQd line: 

A>PIP B:COPY.C0M=A:COPY.CGM 

When PIP stops copying, the system prbmpt will appear again. If 
the fil^ name is not going to change, an even shorter method is 
available- 

A>PIP B:=A:C0PY,COM 
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This command will put a copy of COPY-COM on drive B 
probably the most common CP/AM cominand of all. 

It's easy to copy all files on a diskette with PIP 
greater use of the wild card characters: 



This is 



by making 



A>PIP 



B:=A:*** 



Reniemher, filenames can have eight characters to the left of the 
period, and three characters to the right of the period. The * 
symbol matches any eight characters to the left O'f the period , 
and the .* symbol matches any three characters to the right of 
the period , When using the above command , remember that only 
files ax& copied, the CP/aM system will not be copied. 

The PIP command also has the ability to verify if the fileC^J 
have been transferred correctly by rereading the new file and 
comparing it to the original, PIP can be told to verify the file 
transfers by adding ' [VJ ' suffix to the end of the PIP expression 
as follows: 



d: copy name . typ=d:or iginalname . typi vl 
an exmple of this is; 

h>£lB B:COPY-COM=A:COPY.COM [V] 

after pip has transferred the entire file, it Will go back 
verify tliat the two files are exactly the same- 



and 



STAT 

The STAT command is used to find the general amount of space that 
is left on a disk or the size of a file. The STAT program can be 
executed by typing "STAT", A standard output from STAT may look 
like this: 



A>STAT 

h.: R/W, Spaces 



34k 



This 
.34k of 
a tot 
A sya 
system 
The S 
drives 
lines 
after 



indicates that drive A: can be read and written to and has 
free space left. An Apple disk runnig CP/AM 4 , 0B can store 
al of 126K on a system disk and 138K on a non-system disk- 
tern disk is defined as a disk that contains the operating 
on it so that the disk can be used to boot up CP/AM 4*0B. 
TAT command will display the drive information for all the 
that are currently logged- in , so don' t be alarmed if more 
of information appear , The output from STAT with nothing 
it can be following two forms for each logged disk: 



or 



d : H/w , SPACE ; nqnK 
d; R/0, SPACE; nnnK 



I 
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The R/0 means that the disk In that drive has been changed and 
the new disk has not been logged in with a control C. The files 
on the new disk can still be read, but nothing can be written to 
the disk until it is properly logged in. 

The space left on a Specific disk can be found by typing the 
following; 

A>STAT B; 

8: R/Wr Space: 101k 

This will Only display the information for the specified disk. 
The form for the STAT command is as follows; 

STAT d:f ilename.typ 

The drive specification is optional. If the STAT command is 
followed by a file name (wild card options are allowed) the 
status information about a file along with the information about 
the disk will be displayed; 

A>STAT F0RMAT.COM 
Recs Bytes Pex Ace 

26 4k 1 B/W A; FORMAT ,COM 
a: R/w, Space: 3.4k 

-^ The Recs column shows how many 128 byte records long the file is 
J and the Bytes column shows the amount of disk space that the file 
occupies- If the number of records times eight doesn't equal the 
Bytes colunm don't be alarmed. Because of the way that data is 
stored on the disk the file size will be rounded up if needed, 
but as in this e;(ample, a total of 4k is used to store the file 
on the disk. The Pex colunm shows the number of directory 
extents that the file uses, more information on this can be found 
in any one of the CP/M texts listed at the end of the manual. 
Ace specifies if the file can read and written from, if It had 
been ' H/0 ' the file could only be read. 

A file can be set to a read only status by the following line: 

A>STAT F0RMAT.COM 5R/0 
File set to R/0, 

The file is now set to read only and cannot be written to- To 
change the file so it can be read from and written to use the 
following STAT command form; 

A>STAT FORMAT. COM $a/W 

File set to R/W, 
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BOOT 

The BOOT command tells your Apple to fire up the disk drive cold. 
To execute the BOOT commandr type 'BOOT^ then press return to run 
the program, Tf your favorite space game is in drive 1, get 
ready to dodge missiles- Of course, if the diskette in drive 1 
is a CP/AM dis^, then you're going to go right back to CP/AM- On 
Rpple lie's the control, open Apple, reset is probably the 
easiest way to etatt fresh. However, many hackers insist that 
turning of£ the computer is the only way to start 'clean' - 



CPAM60 " Larger Memory Capacity 

A CP/AM 4,0B master diskette comes configured as a 44K system and 
for 48K Apple systems, this is the largest system that can be 
used, A small minority of programs however, require more memory 
i.e, dBase II, Turbo Pascal, and WordStar 3,3k. If you have an 
Apple lie, //c, or a Franklin Ace 10.00, it is cecommen4ed that 
the CP/AM should be upgraded to 60K. 

If the system being used is an Apple ll+ with a 16K HAM card in 
slot 0, it can PROBABLY be upgraded to a 60K system- It is 
emphasized "probably" with Apple 11+ owners because some Apple 
II+'s and some 16K RAM cards have timing problems that are too 
great for high speed Z-80 operation. If difficulties are 
experienced in upgrading to the 60K system with the Apple II+, 
please read the chapter called 'IN CASE OF DIFFICOLTIES ' , 

When using the following procedure to upgrade the CP/AM disk, it 
ia absolutely essential that only a backup disk be used because 
if something goes wrong the disk may no longer boot up. Also, 
once the master diskette is converted to 60K, there is NO GOING 
BACK to 44K, so always keep copies of the original 44K disk 
around for testing purposes- 

To upgrade to a 62K disk type the following: 
A>CPAM60 

RAMDRIVE - Disk Emulatign 

When running CP/AM with an Apple lie, there is a program that 
will allow CP/AM to use memory in the Apple Tie auxiliary slot as 
a SQlid state disk. Disk emulation, simply put, is the ^ct of 
fooling the Apple computer into thinking that a certain area of 
memory is a disk drive. The program that does this is called 
RAMDRIVE. When used with the Apple extended 80 column card, it 
will emulate half of a disk drive. When used with a 129K or 
larger RAMWORKS card, it will anulate a full drive or more, To 
invoke disk emulation, type: 

A>RAMDHIVE 



■ L 
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Complete information about the RAMDRIVE program can be found in 
the file 'RAMDRIVE.DOC' on the disk. to view the RAHORrVE 
document file type; 

A>TYPE RAMDRIVE.DOC 

with the system disk in drive i. 



RESTOR 

The RESTOR program will unerase any file if it is used before 
any writing is done to the disk. This can be a lifesaver if a 
very important file is accidently erased. The program is 
executed with a command of the following form: 

A>RESTOR filename. typ 

where filename. typ is the name of the file that was erased. If 
the file could be found, its name will appear on the directory. 
The file should checked immediately to see if it is all still 
intact. 



flUTOROK 

The AUTORUN program will make the CP/AM boot disk automatically 
run any program when it is cold booted. As an example, this 
would give the capability to have the RAHDRIVE program 
automatically install the ramdisk drive when the system is 
booted. The form of the program is as follows: 

A>AUTORUN RAMDRIVE 



When the system is cold booted, the Ramdrive program will be run 
just as if it had been typed at the CP/AM prompt. In fact, 
anything that is typed after that AUTORUN name is taken literally 
3s if it was entered at the CP/AM prompt. To replace any 
previous AUTORUN command, jtist re-run the AUTORUN program with 
the new command. To stop CP/AM from executing any command at 
boot time, don't enter anything after the AUTORUN name. This 
program can only modify a system disk ,with CP/AM on it, if 
not a system disk an error message will appear. 



it is 



FORMAT 



FORMAT will completely erase aia of the data On a disk and format 
it in the same way that the INlT command will in DOE 3.3, lO' 
order to create a non-system disk that can hold 138k, run the 
FORMAT program to erase everything (including the CP/AM system) 
from the disk. As long as the CP/AM system is not put on the 
disk, using the COPY program, the 12k of storage that was used 
fQX the operating system can now be used for data storage. To 
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run tbe FORMAT program, type format at the CP/AM prompt and 
follow the instructions. 



HSWEEP 

NSWEEP is a public domain program that has been included on the 
CP/AM disk. This program is an advanced file transferring 
program with many extra capabilities. The documentation for: this 
program is in a disk file labeled ' WSWEEP-DOC ' • It can be viewed 
with the type command- 



TED 

TED is a public domain text editor program that has been included 
on the CP/AH disk- It is a standard type line editor , like ED, 
only with online help screens, A complete document file is 
provided in a squeezed format, which can be viewed or printed out 
with NSWEEP. 
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SDIR 

SDIR is a public doman program that is very similar to the DIR 
command that is built into the CP/AM system- SDIR will display 

all of the files on the disk in alphabetical order and its size 

"in K bytes. After displaying the information oa each file it 

will then display the number of files on the disk and the space 

used by these files, followed by the space remaining on the disk. 



CONFIGIO 

The CONFIGIO program allows the custom installation of the CP/AM 
operating system environment. The CP/AM environment areas that 
the CONETGIO program can change are the hardware and software 
terminal eriulations, the keyboard key re-definitions table, and 
all of the systems input /output [console, list,.,. ,etc) routines 
through special user installable I/O drivers- Note that all 
displayed data is in hex notation and the inputed data must also 
be in hex notation , 

After running the program CONFIGIO, there will be a menu of five 
options. The first is that of the custom terminal emulation , 
After selecting option one, the screen will display the cur cent 
software and hardware terminal screen function definitions. 
Under the software colunm for each of the screen functions will 
be the character sequences that a program will need to send to 
the system to accomplish that particular screen function ■ The 
exceptions to this are the le^d-ia, xy coord offset, and the xy 
xmit order. 

The lead-tn row is the lead-in bharacter definition for any of^ 
the software screen functions that require a Lead-in character , 
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The xy coord offset and xy xmit order are the definition on how 
the address cursor infocmation should be sent to the system. The 
hardware column shows the character sequence that the operation 
system will send out to the physical terminal when it receives 
one of the screen function requests from the software* Through 
this configuration most any program and terminal conbi nation can 
be accommodated. 

The CP/AH operating system is sent out cohfiqured to emulate 
BOROC IQ 120/IQ 140 terminal function codes. with the CONFIGIO 
proqram, this can be changed at any time and can be changed back 
by selecting the default SOROC selection. Note that if the lead- 
in character is set to aero then the lead-in character will be 
disabled, also if any of the screen function definitions are zero 
they will be disabled. 

The keyboard redefinition option from the main menu will allow 
any key on the keyboard to be redefined to another key. There 
can be a maximum of six entries in the keyboard redefinition 
table. The system is sent out with several keys redefined for 
use with the Apple ] [+ computers. The Apple ] [+ computers lacked 
some keys (especially the left bracket key) that are used by 
CP/M programs. If CP/AM is to be operating in a Apple //e or 
//c, then it is advised that all of the entries in the keyboard 
redefinition table be deleted since the //e and //c have these 
keys. This can be accomplished by selecting the delete option in 
the keyboard redefinition menu and entering the hex notatiqn for 
the key that was redefined to delete the redefinition. 

Option number three on the main menu will allow a software 
input/output driver to be loaded in and installed into the CP/AM 
system. The ability to install a driver into the system is 
intended for non-standard hardware products that the CP/AM 
operating system does not support. If needed, these drivers may 
be supplied by the hardware manufaturer, if not, the user will 
need to write one. The format of the driver file is given later 
in the manual . 

All of the preceding options only modified the operation system 
in memory. This means if the system is rebooted ail of the 
previous changes would be gone and the old setting would return. 
To make the current operation system configuration permanent it 
must be written out to a system disk. Option four from the main 
menu will allow system configurations to be read and written to 
from a system disk- It the disk does not contain the system, 
an error message will be displayed- The write option will write 
out the current system configuration to a system disk. Any time 
that the CP/AM system is booted from that disk it will come up 
with the configuration that was last written to it. There is 
also a read option. This will read in a system configuration from 
another disk that may be different from the current system 
configuration on the disk that is being used without needing, to 
permanently modify the disk currently being used* 
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BATCH PROCESSING 

SUBREK 

The SUBHEN command allows CP/RM commands to be stringed together 
for automatic processing. SUBREN creates -procedure files tor 
subsequent processing by the CALL program. The general form ot 
the SUBREN command is: 

SUBREN d:filenane argl ,arg2, , . -argn 

When SUBREH is executed it will search the disk in drive d: for 
a 'batch- file named filename. SUB where filename represents an 
unambiguous filename. (An ambiguous filename is when the wild 
eard characters are used to match one or more files on a disK. 
For a file to be unambiguous do not use the wild card characters, 
if wild card characters are used the resulting filename must 
match only one file on the disk.) SUBKEN will then create the 
procedure file xxS-SUB containing control statements from batch 
file filename. SUB, with symbolic arguments 5i m the batch file 
replaced in the procedure file by literal ^■^g;^«'^"^%f^9i obtained 
from the SUBREN command. For example, the batch file APBOC.SUB 
containing the text lines: 

DIR SI.* 
STAT $1.S2 

would be transformed by the command 

A > SUBREN APROC SLM PBN 

into the procedure file AA$.SUB containing the commands 

DIR SLM.* 
STAT SLM.PBN 

The command 



A>CALL A 

may then be used to invoke this 'procedure A'. I" ^hls example, 
SuIren transformed the batch file APROC.SUB into ^he procedure 
file AA5.SUS called procedure A. The name °f'^he procedure is 
determined by the first character of the batch filename. For 
example, the batch file BPBOC.SUB would be transformed by SUBREN 
into the procedure file BB5.SUB, called procedure B. A P-^^^^dure 
tile can have the name of any valid filename character with any 
number of them may existing at the same time, being m 
conditionally or unconditionally invoked by CALL. 

If double dollar signs '55' appear in a batch tile they will be 
translated by SUBREN into a single dollar sign -5' in the 
procedure file. An alphabetic character -x' preceded by the 
up-arrow character will be translated by SUBREN into ^ single 
control-x character in the procedure file. These conversions 
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J aUoW any character that can be entered at the keybcara to i>e 
placed into a pcocedure file- 



CALL 



J 



The CALL program expands the scope of batch command processing by 
calling any of a number of separate command procedures For 
example; 



AXCALL S 

will invoke the procedure contained in the file BBS.SUB* Each 
procedure file is a batch command file created by SOBHEN. The 
character x is the name of the procedure and can be any 
character, except '$', that is permissible in an unambiguous 
filename. Any file that has the name '$?$.SUB' at warmboot will 
be shifted into batch mode and the next CP/AM command will come 
from the file found which bypasses the advantages provided by the 
CALL program- 



create a batch file 



Osing the SUBREM program and a text editor, 
named AAS.SUB with the following text lines; 

STAT *.ASM 
CALL B 

then create a second batch file named HB$,SUB coata-ining: 

DIP *,DOC 

DIR 

DIR *-COH 



There are now 
BB$,SUS. When 

A>CALL A 



two batch files on t'hB disk named AA5,SUB and 
procedure A Is called with the console command: 



the CALL program will search for a file named AA5.SUB, and if 
found, will rename this file SA5-SUB, then warmboot- Existence 
of a file name beginning with '$' will cause CP/AM to search for 
a file satisfying the ambiguous prototype S?5,SUB- CP/AM will 
find SAS-SUB and will therefore shift into batch mode and ta}ce 
Its next command from the procedure file found. In the example, 
this command will be 

STAT *.ASM 

Following STAT processing, CP/AM is still in batch mode and will 
take its next command from Sa$.SUB. This command will be 

GALL S 

The CALL program first will search for a file satisfying the 
ambiguous prototype $?$.SUB, and when a file such as $A$,SUE is 
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found, it wlZl be renamed AAS.SUB. This deactivates the current 
command procedure with the deactivated file containing all 
remaining unprocessed commands, CALL then searches, in the 
present case, fat a file named BB$-SUB, and if found, renames it 
to SB$.SUB, then warmboots. When CP/AM searches for S?S-SUB it 
will find SBS^SUa and so the next command will be taken from the 
procedure file found, and in the example the command will be 



DIS *.DOG 



This process will continue until all the 
been processed. Note that it does not 
procedure A., 



commands in SsS.SDB have 
return to the previous 



CONDITIONAL CALLS 

A system error flag (RERP) is defined under CP/AM on page zero at 
location 003E hex. Any applications program can set or clear 
this flag. The operating system does not modify this f lag , The 
SETEHR program can also be used to set the system error flag to 
any value through 9, 

Under control of the system error flag, conunand procedures can be 
conditionally invoked by CALL- Eor example, if the system error 
flag is nonzero, 

A>CALL B T 



will invoke the procedure contained in the file BB$.SUB; 
otherwise, if the system error flag is zero, control will pass to 
the next command of the current procedure, or to the console if 
no procedure file exists. 



For demonstration purposes, the program SfiTKRR -**.*. - 
simulate the action of an applications program that 
system error flag to indicate that subsequent pro.cessi 
follow an alternate procedure*. 



will be used to 

sets the 

ng should 



Using a text editor, create 
containing the text lines : 



a main procedure in MAIN, SUB 



1 



SETERR 

CALL A T 

SETERR 1 

CALL A T 
DIR 



Create 
lines : 



an alternate procedure In ALT. SUB containing the text 



SAVE 1 POSTHUN,TMP 
STAT POSTRUN-TMP 

Use SUBREN on both of these files to create the batch files 
MM?, SUB and AA?,SUB, The main procedure can be invoked with the 
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console command 
A>CALL M 



Th& first 

an 



.nnw.fr'"^'''^ ""^ procedure M, SETERR 0, simulates action of 
^^ 'e!^'!"^ program that clears the system error flag to 




command, CALL 
|jrocedure- 



r, wUl invoke procedure ft, the alternate 



ItL r^^ P'^og^am can also use condition codes stored 
system error flag to conditionallv invnV. r..^lJ^T,% 




l^^-.^^.'i: J"' ^' '— " ..: c„«?,„r .;.: 



in the 
files. 

the CALL 

flag the 
example the 

the 



A>CALL C 5 



tJote that the SETERS program can set the system 
value from to 9. ^ 



error flag to any 



SUBMIT 

The SUBMIT program combinds the func 
programs together so that one command 
file and invoke it at one time, when 
will create a procedure file in the 
including arguments, and give it the 
the SUBMIT program finishes running a 
the procedure file will be automaticl 
THIS will eliminate the need to use th 
batch processing. m the example 
commands will be executed from the pr 
to automaticaly run the RAMDRIVE progr 



tions of SUBREN atld CALL 
can both create a procedure 
executed the SUBMIT program 
Same way that SUBREN does, 
filename of 5@5.S[JB- when 
rid a warmboot is performed 
y shifted into batch mode, 
e CALL program to start the 
that follows a series of 
ocedure file 'STARTUP, SUB ' 
am and bring up WordStar. 



Create the file 'STARTUP, SUB' with the following lines; 
RAMDRIVE 

A;WS 

then execute AUTORUN with the following command line: 

a>AUTQRUN SUBMIT STARTUP 

3i^h ^r^ ^'T f ^ ^'^^ '^ ^°^^ ^°^t^^ the WordStar will come 
with the ramdisk as the default drive. 



up 
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This concludes the introduction to the CP/AM system and supplied 
programs- For the general user the remaining sections of the 
manual can be skipped, but for those who have Icnowledqe of 6502 
and Z80 assembly language and plan to write CP/AM system programs 
push on- 
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TECHNICAL NQTES 



6502/Z80 ADDHESS TEiU^SI^TION 

I^/.»'''^^^ ^^. ^^^ ^^^ "^^^^ amount of contiguous membry for the 
^Ih ^°?fi^^ "^ system and from the differences between how the 
ZS0 and 65fl2 processors treat memory areas, it was necessary to 
reorganize the Z80 memory map in the Apple. This is accomplished 
through hardware on the Z80 card and is completely invisible ta 
either processor. The effect of this re-mapping of the Z80 
memory only becomes apparent when trying to execute 6502 
subroutines from the Z80 card or when trying to address a 
specific Apple memory location by the Z80. The following chart 

^ill /^K .^^t ^^^*^^^P°^de"ce between memory accesses from the 
6502 to that of the Z80. 



-Z80 ADDRESS 



6502 ADDRESS 



00fl0K 
1000H 
2000H 
3000H 
4000H 
5000H 
6000U 

7000H 

8000H 

9000H 

A000H 

B000H 

C000H 

D000H' 

E000H- 

-F000H- 



-flFPFH 

-IFFFR 

-2FFFH 

-3FFFH 

-4PFFH 

"5FFFH 

-6FFFH 

-7FFFH 

-8FFFH 

-9FFFH 

-AFFFH 

-BFFFH 

-CFFFH 

-DFFFIT 

-EFFFH. 

-FFFFK 



S1000- 
$2000- 
$3000- 
S4000- 
55000- 
S6000- 
S7000- 
$6000- 
$9000- 
$A000^ 
$B000- 
$0000^ 
$E000- 
$F000^ 
SC000' 
$0000- 



-$1PFF 

'$2FFF 

■$3FFF 

■$4FPF 

'S5FFF 

56FFF 

'S7FFF 

5aFFF 

S9FFF 

$flFFF 

$BFFF 

Sdfff 

$EFFF 
$FFFF 
$CFFP 
$0FFF 



CALLING 6502 SUBROUTINES 

■To call a 6502 subroutine, the address of the routine to be 
called must be placed at memory location F3D0H. The address of 
subroutine must be given as a 6502 address and not Z80, The 
relation between the two addresses are given in the 6502/ZB0 
Address Translation Table. Information can be passed to the 

caned th! .^^^"^''-'^1^^ ''^"^ -registers. When the subroutine is 
called the 6502 registers are automaticaly loaded from the memory 
locations shown below. When all of the needed information is 
initialized the subroutine can be called by performing a write 
operation to the slot address that the Z80 card is located in 
which ean be found in location F3DEH as shown below 



When the write operation is performed the za0 
stopped where it is and 6502 will start running. 
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card will be 
The 6502 will 
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first load 
perform a j 
F3D0H. When 
return from 
contents of 
for the Z80 
address that 
and startup 
instruction. 



its registers from the locations shown below and then 

ump to subroutine operation to the address stored at 

the end of the subroutine is reached , by executing a 

subroutine instruction, the 6502 will store the 

its registers back into the locations shown below, 

to examine, and perform a write operation to the slot 

the Z80 card is located in. This will stop the 6502 

the Z80 where it left off, ready to execute the next 



Note: When the 6502 is activated, the monitor corns are enal^led 
for the 6.502 to use- Care should be taken for the language card 
ram is still write enabled during this time- 



Z80 ADDR 6502 ADDR 



F045H 


$0045 


F046H 


$0046 


F047H 


$0047 


F048H 


$0048 


F049H 


S0049 



F3D0n 



F3DEH 



S03D^ 

S03DE 



PURPOSE 

6502 A register p^ss area 

6502 X register 

6502 Y register 

6502 P (status) register 

6502 S (stack) register 

Address of 6502 subroutine to be called 

Address of the slot the ZB0 card is in 



This is a sample Z80 call to a 6502 monitor subroutine to beep 
the Apple speaker; 



Subroutine to beep the Apple speaker 



; equates 

* 




Z80 
A$SUB 


EQU 
EQU 


0F3OEH 
0F3D0H 


HEG$A 

4 


EQU 


0F045H 


BEEP 


EQU 


0FF3AH 


start: 


XOR 


ft 

(REG$A) ,A 




LD 
LD 
BD 
LD 


HLjBEEP 

(aSsub) ,hl 

HL, (Z80) 
CHL) .A 



; LOCATION OF ZB0 CARD STORED HERE 

;ADDRESS OF 6502 SUBROUTINE TO CALL 
; GOES HERE 

;6502 A REGISTER GOES HERE 

;65.02 MDRESS OF SUBROUTINE TO CALL 

;CLEAR A REGISER 

;TN THIS CALL IT SERVES NO PURPOSE 
; OTHER THAT TO DEMONSTATE PARAMETER 
; PASSING 

;LOAD HL WITH ADDRESS TO CALL 
;STORE 6502 ADDRESS FOR 6502 TO USE 
;GET ADDRESS OF Z80 CARD SLOT 
;WRITE TO SLQT 

THE 6502 EXECUTES SUBROUTINE HERE AND RE-ACTIVATES THE Z80 






I', 



■L? 



.a 



1L»' 



RET 



; RETURN FROM BEEP CALL 



^' 
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CP/AM SYSTEM TABLES 

There are several tables in the CP/AM operating system that 
programs can access to Eind out information about the system 
environment. These tables are listed below: 

This is the internal format of the terminal redefinition table. 
Refer to the CONFIGIO program desciption for more on how the 
software to hardware transfer works. 



SCREEN FUNCTION DEFINITION TABLE 



SOFTWARE 
P396H 



HARDWARE 
F3A1H 



F397Kt 



F3A2H 



DESCRIPTION 

Cursor coordinate offset is contained 
in the lower 7 bits of this byte. The 
high bit is the transmit order of the X 
and Y coordinates. If the high bit is 
zero then the y coordinate is 
transmitted first, if one the X 
coordinate is first. 

Lead-in character, zero if no. ieaa-in. . 



Note: In fallowing bytes the high bit signals if a lead-in 
character is needed, the lower 7 bits contain the character that 
corresponds to that particular function. If the byte for a 
function is zero then that function is disabled. 

Clear screen 

Clear to end of page 

Clear to end of line 

Normal text 

Inverse text of high-line 

Home cursor 

Address cursor 

Move up one line 

Non-destructively move cursor forward 



REDEFINITION TABLE 



F390H 


F3A3H 


F399H 


F3A4H 


F39AH 


F3A5H 


F39BH 


F3A6H 


F39CH 


F3A7H 


F39DH 


F3A8H 


F39EH 


F3A9fl 


F39FH 


F3AAH 


F3A0H 


E"3ABH 



I 






The keyboard redefinition table can contain up to six key 
redefinitions- Each key from the keyboard will be checked 
against this table for a match. If a match is found, then the 
character is replaced with its redefinition. If there is oo 
match, then the character is passed on. If the table is not 
full, the end is marked by the high order bit in the first non- 
used eatry being set to one. 



i 
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KEYBOARD REDEFINITION TABLE 





CHARACTER 


HEDilFIN 


1- 


F3ACH 


F3ADH 


2. 


F3AEH 


F3AFH 


3. 


F3B0a 


F3B1H 


4. 


F3B2H 


F3B3H 


5. 


F3B4H 


F3B5H 


6. 


F3B6H 


F3B7H 



I/O DRIVER VECTOR TABLE. 

This table contains the vector addresses of the subroutines that 
pGrform all of CP/AM's I/O processes, excluding disk 1/0. These 
vectors can be replaced with the CONFIGIO program to point to 
user subroutines. In this way, custom drivers can be installed 
into the CP/AM system to accommadate non-standard cards. 



I/O VECTOR TABLE 



VECTOR NUMBER 



VECTOR NAME 



Console Status 



DESCRIPTION 

Returns 0FFH in register 
A if a character is ready 
to read and 00H if 
otherwise. 



2 

3 

4 
5 



Console Input #1 
Console Input #2 

Console Output #1 
Console Output #2 



Read a character ftOm the 
console into the A register 



Sends a 

register 

device, 

contains 

standard 

sending 

function 

contains 

function 



character in 
C to the console 
Register B 
zero if a 

character or if 

out a screen 

command it 

the screen 

number • 



7 



Reader Input #1 
Reader Input #2 



Reads a character from 
the reader device into 
register A- 



Punch Output #1 
Punch Output #2 



gends the character in 
register C to the punch 
dev i ce • 



10 
11 



List Output #1 
List Output #2 



Sends the character in 
register C to the printer 
device. 
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t^OGlCAL TO PHYSICAL I/O DEVICES 

The CP/AM lOBYTE located at 0003H can be used to redirect the fc 

CP/AM logical Input and output devices to different I/O vector 
table locations. The lOBYTE has the following struct.ucei 



LIST I PUNCH I READER I CONSOLE 



76 5; 432 1 bit locations 
Console field: 

- Console Input #1 and Console Output #1 

1 - Console Input #1 and Console Output #1 

2 - Reader Input #1 and List Output #1 

3 - Console Input #2 and Console Output #2 

Reader field 



- Console Input #1 

1 - Console Input #1 

2 - Reader Input #1 

3 " Reader Input #2 



Punch field 



1 
1 
1 



- Console Output #1 

1 - Punch Output #1 

2 - Reader Input #2 (data is outputed through this vector) 

3 - Punch Output #2 

List fieia 

- Console Output #1 

1 - Console Output #1 

2 - List Output #1 

3 " List Output #2 

In order to use tlie CONFIGIO program to install custom drivers, a 
specially formatted file will have to be created* This Eile will 
be read in by option number three in the CONFIGIO program and 
will be automaticelly installed into the operating system* The 
format for this file is as follows: 

First byte: Number of patches to be made. 

Repeat for each I/O driver to install 

Next 2 bytes; Destination address of subroutine CO^. | 

Next 2 bytes: Length of subroutine code. 

Next byte: Driver patch type 1 or 2 
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If driver patch type 1: 



Next byte; 
Next 2 bytes: 



I/O vector number to patch, 
Address to be placed into l/O 
defined above , 



vector 



If (3civex patch type 2: 



Hext Byte: 
Next 2 Bytesj 



I/O vector number to patch - 

Address into which to move the current 

pon tents of I/O vector defined above . 



Mext 2 bytes: 



Next : 



Address to be placed into I/O vector 
defined above , 

The driver CCde is placed here after the 
driver patch type information above _ 
The next byte after the driver code can 
be another driver where the first byte 
of the file defines how many driver I/O 
patches to be made. 

Inside the CP/AM system, there is a special area that is set 
aside for user installed device drivers. This area ranges from 
F200H to F37FH. If a driver is to be installed permanently into 
the operating system, it must reside in this area too so that it 
ma? be written out to a system disk with the read/write I/O 
configuration block option in the CONFIOGIO program- Also note 
that when the HAMDRIVE program is running the I/O block area 
F280H to F37FH will be overwritten for the ramdrive progiam 
usage. 

Here is an example of a device driver patch to automatically 
remove liae feed characters for printers that automatically 
advance to the next line after each carriage return. 






I 



LIST DEVICE PATCH 
ORG 100H 



ORIGIN 

OFFSET 



EQU 0F300H 

EQU ORIGIK-START 



;THIS IS SO THE LOAD COMWAN0 WILL 

; LOAD IT AT 100H 

;SEAL ORIGIN OF PROGRAM 



DB 

DW 

DW 

DB 

DB 
DW 

DW 



1 
0F300H 

PGMBND -START 

2 



;ONE PATCH TO BE MADE 
;ADDRESS OF WHERE TO LOAD THE 
; DRIVER PATCH 
;,LENGTH OF DRIVER CODE 

; PATCH TYPE 

fCHANGE I/O VECTOR 10 



0AH 

OUTPtJT + 0FFSET + l;ADDRESS WH"ERE TO PUT CURRENT VECTOR 

; CONTENTS 
START+OFFSET ;NEW ADDRESS TO PUT IN I /O VECTOR 



J 
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START: 
OUTPDT: 



LD A,C 
CP 0AH 
CALL NZr0000H 



RET 
END 



;MOVE OUTPUT CHARACTER TO A 
;CHECK FOR LINE FEED CHARACTER 
;SEND CHARACTER TO PRINTER IF NOT 
; A LINE FEED, OTHERWISE CONTINUE 
; ON WITHOUT PRINTING LINE FEED 
; RETURN TO DRIVER CALLER 



The object code for this driver would be: 

01 00 P3 07 00 02 0A 04 F3 00 F3 79 FE 0A C4 00 00 C9 



I 

I 



PERIPHERAL CAKD SLOT TABLE 



This tabl 
cards are 
starts at 
for each 
card type 
controller 
two for 
correspond 
one disk 
describes 



e contains inf 
located in each 

location F3B8H 
slot number S, 
ID byte but 

cards found in 
each card found 
a to the number 
drive will have 
the the meaning 



orraation about what type of peripheral 
slot of the Apple computer. The table 

, where F3B8H + S contains the ID byte 
Slot zero CF3B8H) does not contain a 
a count of the number of disk drive 
the system. This counter increments by 
Do not confuse this by thinking it 
of disk drives, for a system with only 
a count of two. The following table 
of each ID byte. 



- No peripheral card ROM was found 

1 - A peripheral card ROM was found, but not identified 

2 - A disk controller card was found 

3 - An Apple conrnunications interface type card was found 

4 - A high speed type serial card was found, usually an 80-colunm 

card 

5 - A parallel printer type card was found 

6 - A card following Apple Pascal 1.1 & PRODOS protocol 



INTERRUPT HANDLING 

From the way that the Z80 card uses the DMA line to deactivate 
the 6502, all interrupt processing must be handled by the 6502. 
To enable maskable interrupts, the IRQ solder pad on the Z80 card 
must be connected, non-maskable interrupts are not available. If 
the interrupt comes when the 6502 is active, interrupt handling 
is done in the standard way. When the Z80 is active the 
following steps must be followed: 



1. 
2. 



3. 



Save any registers that are destroyed on the stack 

Save the contents of the 6502 subroutine call address in 

case an interrupt has occurred during the preparation for 

a 6502 subroutine call 

Set up the 6502 subroutine call address to $ff58, which 
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1 



n 
7 

8 



i s the addcess 
monitor ROM. 
Return control 

address oL the Z 
will immeJiatel 
interrupt handi 
interrupt rout 
instruction and 
manager . 
Lvhen the :-;S'if is 
subroutine cal 1 
Restore all used 
Enable ZSfl i nter 
Return LLQiw Z\iQ 



of a 6502 RTS insttLictioi-j 



in 



the Aj^3[jle 



to the 6502 by writing to the slot 
S0 card. When the 6502 regains control it 
y "see" the interrupt and jump to its 



ing routine. Upon return 
ine, the 6502 will execute 

rea.rLi vnte the Z90 through 



from the 

the RTS 
the call 



reactivated restore 
address 

Z80 registers from the stack 
rupts with the EI instruction 
interrupt routine wi tn RET I 



the previous 6502 



^2 



J 



J 



^sr 



WHY THE Z-80? 



reason foe having a Z-80 card in your Apple is so 
run CP/M software in your computer , CP/H is an 
sold and marketed by various software producers 
by Digital Research, Inc. CP/M was the first 
operating system. It is still the most widely 
available. The wide support means more software 
a user.. You now have a choice of many 
processing, accounting, business and 
professional software packages when you have a Z-80 Plus card, 
unlike standard Apple DOS, CP/M supports many languages in 
addition to Basic, Fortran, Cobol, and Basic Compiler are 
available, CP/M has many conveniences not found in Apple DOS 
such as fast disk I/O, better interface to machine language 
programs, simpler file transfer and wild card file naming 
conventions that allow you to refer to multiple files with one 
naffle. 



your primary 
that you can 
advanced DOS 
under license 
microcomputer 
supported one 
choices fox you as 
sophisticated word 



h 
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WHAT IS THE PRIMARY DIFFERENCE BETWEEN THE Z-80 AND THE 6502? 



The Z-a 
memory 
four 16 
are also 
programs 
80B5 in 
However, 
arithmet 



is a register oriented processor vherea 

oriented. The Z-80 contains 13 eight bit 
bit registers. Two accumulators and two 
provided. Moreover, all 8080 and 8085 as 
wi 11 run unmodified on Z-80 systems becau 

struction code is a subset of the Z-80 ins 
many instructions have been added elimina 

ic and data processing shortcomings. 



s the 6502 is 
registers and 

flag registers 
sembly language 
se the B080 and 
truction code- 
ting the 8080's 
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ADDRNDUMS for WordStar 3.3x 



Fixing the inverse problem with WordStar 3,3x on Apple computer. 

If the inverse video is backwards or not working properly, the 
following fix can be used to correct the problem: 



J 



1. 
2. 

3* 
4, 
5. 
6. 

7. 
8. 
9- 

10, 
11. 
12. 
13. 
14, 



fiun the CONFTGIO program. 
Select option 1 on the main menu. 
Select option E on the terminal screen menu 
Enter N for no leadin. 
Enter 0F for the character code- 
Enter H for hardware function. 
Select option F on the terminal screen menu. 
Enter N for no leadin. 
Enter 0E for the character code. 
Enter H for hardware function - 
Enter X to exit to main menu. 
Select option 4 on the main menu. 

Enter w to write the new terminal configuration to the disk 
Select X to exit the CONFIGIO program. 



1 






1 

1 
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IN CASE OP DIFFICULTY 

Should CP/M fail to boot using your z-80 Plus, please check: 
(This guide is valid foe any Z^B0 card not just the Z-80 Plus- ) 

Make sure your software is good. Try your software in another 
Apple known to work with CP/M. Modems, 80 column cards and other 
boards with a lot of firmware on them tend to confuse CP/M and 
ALL Z-80 cards. Try removing these cards first and then retry 
CP/M. Often, putting the Z-80 in slot 7 solves conflicts with 
other boards - 

Xf you still have trouble, you may test the Z-80 Plus by putting 
it in another Apple, using a disk known to work. 

The following is a list of the most likely fault in your system: 

1} Bad software, disk is partially erased, or you have a 56K or 
60K disk with a 48K apple. Always try a 44K disk if you have 
problems. 



2) Bad 16K RAM card (try tradi 
16K card does everything el 
that will not let it work 
hardware fault in an Apple 
Apple language card are th 
replace your 16K card may 
16k card has no jumper to 
to 64K RAM! It works too. 
8750. Applied Engineering 



ng wi th a friend J 
se fine it can st 
with CP/M. This 
J [ or J [+- The Mic 
e most unreliable, 
we recommend the 
the mother board 
Call (214J 361-7 
does not sell the 



Even if your 
ill have a problem 
is the most likely 
rosoft 16K and the 
If you decide to 
S,T,B, 16K, This 
and is upgradeable 
831 or (214) 234- 
S.T,B 16K. 



I 

I 



3} The I.e. at location B2 (74LS245J is bad or weak on the Apple 
J [e, (If you replace this I .C. do not use FAIRCHILD 
or SIGNETICS. Use MITSUBISHI or NATIONAL or T,l.). T,I, is 
the best. Remember Apple buys its I.C.'s from the lowest 
bidder. Due to the complaints from all z-80 card 
manufacturers, Apple has stopped using FAIRCHILD and SIGNETICS 
at location B2, 



\ 



4) Bad Z-afl Plus card. Very unlikely, each card is 
Apples (two Jle's and one i[+) . 



tested in three 
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For Further Reading: 

These books are available at most bookstores. 

The CP/M Handbook by Rodney 2aks * 

Published by Sybex Inc, a very good 

2344 6th Street, Dept. A CP/M manual 

Berkeley, California 94710 

1-800-227-2346 

Introduction to Wordstar by Arthur Naiman * 

Published by Sybex a very good 

2344 6th Street, Dept. A WordStar manual 

Berkeley, California 94710 

1-800-227-2346 

Microsoft BASIC * 

Published by Dilithium Press 
11000 S.W, 11th Street Suite E 
Beaverton, OR 97005 
(503} 646-2713 

dBASE II users guide 

Pubished by Green/Prentice-Hall 

CP/M and the Personal Computer 

Dwyer and Critchf ield/Addison-Wesley ^ 

Programming the Z-80 by Rodney Zaks ^ 

Published by Sybex Inc- _ 
2344 6th Street, Dept A 

Berkeley, California 94710 -^ 

How to Get Started With CP/M by Carl Townsend - 

Published by Dilithium Press ^ 

P. 0, Box 606 

Beaverton, Oregon 97005 — 

I 

CP/M Assembly Language Programming by Ken Barbier j 

published by Prentice-Hall, Inc. JT 

Englewood Cliffs, New Jersey 07632 

z-80 Programming and interfacing 
Published by Howard Sams, Inc, 
4300 west 62nd Street 
Indianapolis, Indiana 46268 



* Most recommended 
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